home *** CD-ROM | disk | FTP | other *** search
llllooooccccaaaalllleeeeccccoooonnnnvvvv((((3333CCCC)))) llllooooccccaaaalllleeeeccccoooonnnnvvvv((((3333CCCC)))) NNNNAAAAMMMMEEEE _llll_oooo_cccc_aaaa_llll_eeee_cccc_oooo_nnnn_vvvv - get numeric formatting information SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_llll_oooo_cccc_aaaa_llll_eeee_...._hhhh_>>>> _ssss_tttt_rrrr_uuuu_cccc_tttt _llll_cccc_oooo_nnnn_vvvv _****_llll_oooo_cccc_aaaa_llll_eeee_cccc_oooo_nnnn_vvvv _((((_vvvv_oooo_iiii_dddd_))))_;;;; DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN _llll_oooo_cccc_aaaa_llll_eeee_cccc_oooo_nnnn_vvvv sets the components of an object with type _ssss_tttt_rrrr_uuuu_cccc_tttt _llll_cccc_oooo_nnnn_vvvv (defined in _llll_oooo_cccc_aaaa_llll_eeee_...._hhhh) with the values appropriate for the formatting of numeric quantities (monetary and otherwise) according to the rules of the current locale [see _ssss_eeee_tttt_llll_oooo_cccc_aaaa_llll_eeee(3C)]. The definition of _ssss_tttt_rrrr_uuuu_cccc_tttt _llll_cccc_oooo_nnnn_vvvv is given below (the values for the fields in the _CCCC locale are given in comments): _cccc_hhhh_aaaa_rrrr _****_dddd_eeee_cccc_iiii_mmmm_aaaa_llll______pppp_oooo_iiii_nnnn_tttt_;;;; _////_**** _""""_...._"""" _****_//// _cccc_hhhh_aaaa_rrrr _****_tttt_hhhh_oooo_uuuu_ssss_aaaa_nnnn_dddd_ssss______ssss_eeee_pppp_;;;; _////_**** _""""_"""" _((((_zzzz_eeee_rrrr_oooo _llll_eeee_nnnn_gggg_tttt_hhhh _ssss_tttt_rrrr_iiii_nnnn_gggg_)))) _****_//// _cccc_hhhh_aaaa_rrrr _****_gggg_rrrr_oooo_uuuu_pppp_iiii_nnnn_gggg_;;;; _////_**** _""""_"""" _****_//// _cccc_hhhh_aaaa_rrrr _****_iiii_nnnn_tttt______cccc_uuuu_rrrr_rrrr______ssss_yyyy_mmmm_bbbb_oooo_llll_;;;; _////_**** _""""_"""" _****_//// _cccc_hhhh_aaaa_rrrr _****_cccc_uuuu_rrrr_rrrr_eeee_nnnn_cccc_yyyy______ssss_yyyy_mmmm_bbbb_oooo_llll_;;;; _////_**** _""""_"""" _****_//// _cccc_hhhh_aaaa_rrrr _****_mmmm_oooo_nnnn______dddd_eeee_cccc_iiii_mmmm_aaaa_llll______pppp_oooo_iiii_nnnn_tttt_;;;; _////_**** _""""_"""" _****_//// _cccc_hhhh_aaaa_rrrr _****_mmmm_oooo_nnnn______tttt_hhhh_oooo_uuuu_ssss_aaaa_nnnn_dddd_ssss______ssss_eeee_pppp_;;;; _////_**** _""""_"""" _****_//// _cccc_hhhh_aaaa_rrrr _****_mmmm_oooo_nnnn______gggg_rrrr_oooo_uuuu_pppp_iiii_nnnn_gggg_;;;; _////_**** _""""_"""" _****_//// _cccc_hhhh_aaaa_rrrr _****_pppp_oooo_ssss_iiii_tttt_iiii_vvvv_eeee______ssss_iiii_gggg_nnnn_;;;; _////_**** _""""_"""" _****_//// _cccc_hhhh_aaaa_rrrr _****_nnnn_eeee_gggg_aaaa_tttt_iiii_vvvv_eeee______ssss_iiii_gggg_nnnn_;;;; _////_**** _""""_"""" _****_//// _cccc_hhhh_aaaa_rrrr _iiii_nnnn_tttt______ffff_rrrr_aaaa_cccc______dddd_iiii_gggg_iiii_tttt_ssss_;;;; _////_**** _CCCC_HHHH_AAAA_RRRR______MMMM_AAAA_XXXX _****_//// _cccc_hhhh_aaaa_rrrr _ffff_rrrr_aaaa_cccc______dddd_iiii_gggg_iiii_tttt_ssss_;;;; _////_**** _CCCC_HHHH_AAAA_RRRR______MMMM_AAAA_XXXX _****_//// _cccc_hhhh_aaaa_rrrr _pppp______cccc_ssss______pppp_rrrr_eeee_cccc_eeee_dddd_eeee_ssss_;;;; _////_**** _CCCC_HHHH_AAAA_RRRR______MMMM_AAAA_XXXX _****_//// _cccc_hhhh_aaaa_rrrr _pppp______ssss_eeee_pppp______bbbb_yyyy______ssss_pppp_aaaa_cccc_eeee_;;;; _////_**** _CCCC_HHHH_AAAA_RRRR______MMMM_AAAA_XXXX _****_//// _cccc_hhhh_aaaa_rrrr _nnnn______cccc_ssss______pppp_rrrr_eeee_cccc_eeee_dddd_eeee_ssss_;;;; _////_**** _CCCC_HHHH_AAAA_RRRR______MMMM_AAAA_XXXX _****_//// _cccc_hhhh_aaaa_rrrr _nnnn______ssss_eeee_pppp______bbbb_yyyy______ssss_pppp_aaaa_cccc_eeee_;;;; _////_**** _CCCC_HHHH_AAAA_RRRR______MMMM_AAAA_XXXX _****_//// _cccc_hhhh_aaaa_rrrr _pppp______ssss_iiii_gggg_nnnn______pppp_oooo_ssss_nnnn_;;;; _////_**** _CCCC_HHHH_AAAA_RRRR______MMMM_AAAA_XXXX _****_//// _cccc_hhhh_aaaa_rrrr _nnnn______ssss_iiii_gggg_nnnn______pppp_oooo_ssss_nnnn_;;;; _////_**** _CCCC_HHHH_AAAA_RRRR______MMMM_AAAA_XXXX _****_//// The members of the structure with type _cccc_hhhh_aaaa_rrrr _**** are strings, any of which (except _dddd_eeee_cccc_iiii_mmmm_aaaa_llll______pppp_oooo_iiii_nnnn_tttt) can point to _""""_"""", to indicate that the value is not available in the current locale or is of zero length. The members with type _cccc_hhhh_aaaa_rrrr are nonnegative numbers, any of which can be _CCCC_HHHH_AAAA_RRRR______MMMM_AAAA_XXXX (defined in the _llll_iiii_mmmm_iiii_tttt_ssss_...._hhhh header file) to indicate that the value is not available in the current locale. The members are the following: _cccc_hhhh_aaaa_rrrr _****_dddd_eeee_cccc_iiii_mmmm_aaaa_llll______pppp_oooo_iiii_nnnn_tttt The decimal-point character used to format non-monetary quantities. _cccc_hhhh_aaaa_rrrr _****_tttt_hhhh_oooo_uuuu_ssss_aaaa_nnnn_dddd_ssss______ssss_eeee_pppp The character used to separate groups of digits to the left of the decimal-point character in formatted non-monetary quantities. _cccc_hhhh_aaaa_rrrr _****_gggg_rrrr_oooo_uuuu_pppp_iiii_nnnn_gggg A string in which each element is taken as an integer that indicates the number of digits that comprise the current group in a formatted PPPPaaaaggggeeee 1111 llllooooccccaaaalllleeeeccccoooonnnnvvvv((((3333CCCC)))) llllooooccccaaaalllleeeeccccoooonnnnvvvv((((3333CCCC)))) non-monetary quantity. The elements of _gggg_rrrr_oooo_uuuu_pppp_iiii_nnnn_gggg are interpreted according to the following: _CCCC_HHHH_AAAA_RRRR______MMMM_AAAA_XXXX No further grouping is to be performed. _0000 The previous element is to be repeatedly used for the remainder of the digits. _o_t_h_e_r The value is the number of digits that comprise the current group. The next element is examined to determine the size of the next group of digits to the left of the current group. _cccc_hhhh_aaaa_rrrr _****_iiii_nnnn_tttt______cccc_uuuu_rrrr_rrrr______ssss_yyyy_mmmm_bbbb_oooo_llll The international currency symbol applicable to the current locale, left-justified within a four-character space-padded field. The character sequences should match with those specified in: _I_S_O _4_2_1_7:_1_9_8_7 _C_o_d_e_s _f_o_r _t_h_e _R_e_p_r_e_s_e_n_t_a_t_i_o_n _o_f _C_u_r_r_e_n_c_y _a_n_d _F_u_n_d_s. _cccc_hhhh_aaaa_rrrr _****_cccc_uuuu_rrrr_rrrr_eeee_nnnn_cccc_yyyy______ssss_yyyy_mmmm_bbbb_oooo_llll The local currency symbol applicable to the current locale. _cccc_hhhh_aaaa_rrrr _****_mmmm_oooo_nnnn______dddd_eeee_cccc_iiii_mmmm_aaaa_llll______pppp_oooo_iiii_nnnn_tttt The decimal point used to format monetary quantities. _cccc_hhhh_aaaa_rrrr _****_mmmm_oooo_nnnn______tttt_hhhh_oooo_uuuu_ssss_aaaa_nnnn_dddd_ssss______ssss_eeee_pppp The separator for groups of digits to the left of the decimal point in formatted monetary quantities. _cccc_hhhh_aaaa_rrrr _****_mmmm_oooo_nnnn______gggg_rrrr_oooo_uuuu_pppp_iiii_nnnn_gggg A string in which each element is taken as an integer that indicates the number of digits that comprise the current group in a formatted monetary quantity. The elements of _mmmm_oooo_nnnn______gggg_rrrr_oooo_uuuu_pppp_iiii_nnnn_gggg are interpreted according to the rules described under _gggg_rrrr_oooo_uuuu_pppp_iiii_nnnn_gggg. _cccc_hhhh_aaaa_rrrr _****_pppp_oooo_ssss_iiii_tttt_iiii_vvvv_eeee______ssss_iiii_gggg_nnnn The string used to indicate a nonnegative-valued formatted monetary quantity. _cccc_hhhh_aaaa_rrrr _****_nnnn_eeee_gggg_aaaa_tttt_iiii_vvvv_eeee______ssss_iiii_gggg_nnnn The string used to indicate a negative-valued formatted monetary quantity. _cccc_hhhh_aaaa_rrrr _iiii_nnnn_tttt______ffff_rrrr_aaaa_cccc______dddd_iiii_gggg_iiii_tttt_ssss The number of fractional digits (those to the right of the decimal point) to be displayed in an internationally formatted monetary quantity. _cccc_hhhh_aaaa_rrrr _ffff_rrrr_aaaa_cccc______dddd_iiii_gggg_iiii_tttt_ssss The number of fractional digits (those to the right of the decimal point) to be displayed in a formatted monetary quantity. PPPPaaaaggggeeee 2222 llllooooccccaaaalllleeeeccccoooonnnnvvvv((((3333CCCC)))) llllooooccccaaaalllleeeeccccoooonnnnvvvv((((3333CCCC)))) _cccc_hhhh_aaaa_rrrr _pppp______cccc_ssss______pppp_rrrr_eeee_cccc_eeee_dddd_eeee_ssss Set to 1 or 0 if the _cccc_uuuu_rrrr_rrrr_eeee_nnnn_cccc_yyyy______ssss_yyyy_mmmm_bbbb_oooo_llll respectively precedes or succeeds the value for a nonnegative formatted monetary quantity. _cccc_hhhh_aaaa_rrrr _pppp______ssss_eeee_pppp______bbbb_yyyy______ssss_pppp_aaaa_cccc_eeee Set to 1 or 0 if the _cccc_uuuu_rrrr_rrrr_eeee_nnnn_cccc_yyyy______ssss_yyyy_mmmm_bbbb_oooo_llll respectively is or is not separated by a space from the value for a nonnegative formatted monetary quantity. _cccc_hhhh_aaaa_rrrr _nnnn______cccc_ssss______pppp_rrrr_eeee_cccc_eeee_dddd_eeee_ssss Set to 1 or 0 if the _cccc_uuuu_rrrr_rrrr_eeee_nnnn_cccc_yyyy______ssss_yyyy_mmmm_bbbb_oooo_llll respectively precedes or succeeds the value for a negative formatted monetary quantity. _cccc_hhhh_aaaa_rrrr _nnnn______ssss_eeee_pppp______bbbb_yyyy______ssss_pppp_aaaa_cccc_eeee Set to 1 or 0 if the _cccc_uuuu_rrrr_rrrr_eeee_nnnn_cccc_yyyy______ssss_yyyy_mmmm_bbbb_oooo_llll respectively is or is not separated by a space from the value for a negative formatted monetary quantity. _cccc_hhhh_aaaa_rrrr _pppp______ssss_iiii_gggg_nnnn______pppp_oooo_ssss_nnnn Set to a value indicating the positioning of the _pppp_oooo_ssss_iiii_tttt_iiii_vvvv_eeee______ssss_iiii_gggg_nnnn for a nonnegative formatted monetary quantity. The value of _pppp______ssss_iiii_gggg_nnnn______pppp_oooo_ssss_nnnn is interpreted according to the following: _0000 Parentheses surround the quantity and _cccc_uuuu_rrrr_rrrr_eeee_nnnn_cccc_yyyy______ssss_yyyy_mmmm_bbbb_oooo_llll. _1111 The sign string precedes the quantity and _cccc_uuuu_rrrr_rrrr_eeee_nnnn_cccc_yyyy______ssss_yyyy_mmmm_bbbb_oooo_llll. _2222 The sign string succeeds the quantity and _cccc_uuuu_rrrr_rrrr_eeee_nnnn_cccc_yyyy______ssss_yyyy_mmmm_bbbb_oooo_llll. _3333 The sign string immediately precedes the _cccc_uuuu_rrrr_rrrr_eeee_nnnn_cccc_yyyy______ssss_yyyy_mmmm_bbbb_oooo_llll. _4444 The sign string immediately succeeds the _cccc_uuuu_rrrr_rrrr_eeee_nnnn_cccc_yyyy______ssss_yyyy_mmmm_bbbb_oooo_llll. _cccc_hhhh_aaaa_rrrr _nnnn______ssss_iiii_gggg_nnnn______pppp_oooo_ssss_nnnn Set to a value indicating the positioning of the _nnnn_eeee_gggg_aaaa_tttt_iiii_vvvv_eeee______ssss_iiii_gggg_nnnn for a negative formatted monetary quantity. The value of _nnnn______ssss_iiii_gggg_nnnn______pppp_oooo_ssss_nnnn is interpreted according to the rules described under _pppp______ssss_iiii_gggg_nnnn______pppp_oooo_ssss_nnnn. RRRREEEETTTTUUUURRRRNNNNSSSS _llll_oooo_cccc_aaaa_llll_eeee_cccc_oooo_nnnn_vvvv returns a pointer to the filled-in object. The structure pointed to by the return value may be overwritten by a subsequent call to _llll_oooo_cccc_aaaa_llll_eeee_cccc_oooo_nnnn_vvvv. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS The following table illustrates the rules used by four countries to format monetary quantities. Country Positive format Negative formatInternational format Italy L.1.234 -L.1.234 ITL.1.234 Netherlands F 1.234,56 F -1.234,56NLG 1.234,56 Norway kr1.234,56 kr1.234,56-NOK 1.234,56 PPPPaaaaggggeeee 3333 llllooooccccaaaalllleeeeccccoooonnnnvvvv((((3333CCCC)))) llllooooccccaaaalllleeeeccccoooonnnnvvvv((((3333CCCC)))) Switzerland SFrs.1,234.56 SFrs.1,234.56CCHF 1,234.56 For these four countries, the respective values for the monetary members of the structure returned by _llll_oooo_cccc_aaaa_llll_eeee_cccc_oooo_nnnn_vvvv are as follows: Italy Netherlands NorwaySwitzerland _iiii_nnnn_tttt______cccc_uuuu_rrrr_rrrr______ssss_yyyy_mmmm_bbbb_oooo_llll _""""_IIII_TTTT_LLLL_...._"""" _""""_NNNN_LLLL_GGGG _"""" _""""_NNNN_OOOO_KKKK _""""_""""_CCCC_HHHH_FFFF _"""" _cccc_uuuu_rrrr_rrrr_eeee_nnnn_cccc_yyyy______ssss_yyyy_mmmm_bbbb_oooo_llll _""""_LLLL_...._"""" _""""_FFFF_"""" _""""_kkkk_rrrr_""""_""""_SSSS_FFFF_rrrr_ssss_...._"""" _mmmm_oooo_nnnn______dddd_eeee_cccc_iiii_mmmm_aaaa_llll______pppp_oooo_iiii_nnnn_tttt _""""_"""" _""""_,,,,_"""" _""""_,,,,_""""_""""_...._"""" _mmmm_oooo_nnnn______tttt_hhhh_oooo_uuuu_ssss_aaaa_nnnn_dddd_ssss______ssss_eeee_pppp _""""_...._"""" _""""_...._"""" _""""_...._""""_""""_,,,,_"""" _mmmm_oooo_nnnn______gggg_rrrr_oooo_uuuu_pppp_iiii_nnnn_gggg _""""_\\\\_3333_"""" _""""_\\\\_3333_"""" _""""_\\\\_3333_"""" _""""_\\\\_3333_"""" _pppp_oooo_ssss_iiii_tttt_iiii_vvvv_eeee______ssss_iiii_gggg_nnnn _""""_"""" _""""_"""" _""""_"""" _""""_"""" _nnnn_eeee_gggg_aaaa_tttt_iiii_vvvv_eeee______ssss_iiii_gggg_nnnn _""""_----_"""" _""""_----_"""" _""""_----_"""" _""""_CCCC_"""" _iiii_nnnn_tttt______ffff_rrrr_aaaa_cccc______dddd_iiii_gggg_iiii_tttt_ssss _0000 _2222 _2222_2222 _ffff_rrrr_aaaa_cccc______dddd_iiii_gggg_iiii_tttt_ssss _0000 _2222 _2222 _2222 _pppp______cccc_ssss______pppp_rrrr_eeee_cccc_eeee_dddd_eeee_ssss _1111 _1111 _1111 _1111 _pppp______ssss_eeee_pppp______bbbb_yyyy______ssss_pppp_aaaa_cccc_eeee _0000 _1111 _0000_0000 _nnnn______cccc_ssss______pppp_rrrr_eeee_cccc_eeee_dddd_eeee_ssss _1111 _1111 _1111 _1111 _nnnn______ssss_eeee_pppp______bbbb_yyyy______ssss_pppp_aaaa_cccc_eeee _0000 _1111 _0000_0000 _pppp______ssss_iiii_gggg_nnnn______pppp_oooo_ssss_nnnn _1111 _1111 _1111 _1111 _nnnn______ssss_iiii_gggg_nnnn______pppp_oooo_ssss_nnnn _1111 _4444 _2222 _2222 FFFFIIIILLLLEEEESSSS _////_uuuu_ssss_rrrr_////_llll_iiii_bbbb_////_llll_oooo_cccc_aaaa_llll_eeee_////_l_o_c_a_l_e_////_LLLL_CCCC______MMMM_OOOO_NNNN_EEEE_TTTT_AAAA_RRRR_YYYY _LLLL_CCCC______MMMM_OOOO_NNNN_EEEE_TTTT_AAAA_RRRR_YYYY database for _l_o_c_a_l_e _////_uuuu_ssss_rrrr_////_llll_iiii_bbbb_////_llll_oooo_cccc_aaaa_llll_eeee_////_l_o_c_a_l_e_////_LLLL_CCCC______NNNN_UUUU_MMMM_EEEE_RRRR_IIII_CCCC _LLLL_CCCC______NNNN_UUUU_MMMM_EEEE_RRRR_IIII_CCCC database for _l_o_c_a_l_e SSSSEEEEEEEE AAAALLLLSSSSOOOO _mmmm_oooo_nnnn_tttt_bbbb_llll(1M), _ssss_eeee_tttt_llll_oooo_cccc_aaaa_llll_eeee(3C). PPPPaaaaggggeeee 4444 
